home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1997 / MacHack 1997.toast / Hacks / Hacks ’96 / Audio dcmds / Audio CD dcmds.sit / Audio CD dcmds.π / Read me first ! < prev    next >
Text File  |  1994-08-31  |  5KB  |  118 lines
  1.    ************************
  2.    *  Think C dcmd 1.0.1  *
  3.    ************************
  4.  
  5.    Written by P. Stadelmann, August 1994.
  6.  
  7. •• Introduction ••
  8.  
  9.    This package allows you to write dcmds in Think C. It contains the glue code
  10.    necessary to link the "dcmd.o" library, and Think Put, a collection of routines
  11.    to create formatted output in dcmds.
  12.    
  13.    IMPORTANT : There is no change in the interface between version 1.0 and 1.0.1
  14.                Thus, there is no need to modifiy your code.
  15.  
  16. •• How to use (Think C 7.0 or later) ••
  17.  
  18.    The following applies to Think C 7.0 or later. If you use an earlier version
  19.    of Think C, please refer to "How to use (Think C 6.0.x or earlier)"
  20.  
  21. 1) Put the files "Think_dcmd.h", "Think_put.h", "Think dcmd glue" and "Think Put Lib"
  22.    where the Project Manager can find them (like in the "Mac Librairies" and
  23.    "Mac #includes" folders).
  24.  
  25. 2) Do the same with the files "dcmd.h" and "dcmdGlue.a.o". These files are available
  26.    along with MacsBug from ftp.apple.com in the dts/mac/tools/macsbug/ directory.
  27.  
  28. 3) Drop the folder named "Think dcmd" into the (Project Models) folder.
  29.    
  30. 4) In the Project Manager, create a new project. Choose "Think dcmd" in project list.
  31.    Add your code in the dcmd.c file : write the CommandEntry code as described in 
  32.    chapter 8 of the book "MacsBug Reference and Debugging Reference" from
  33.    Apple Computer, Inc.
  34.  
  35. 5) Use the "Set Project Type" command to choose the name and id of your dcmd. Remember
  36.    that the dcmd name (used to run the dcmd in MacsBug) is the name of the dcmd resource.
  37.  
  38. 6) Once you have built the dcmd, use a resource editor to copy the dcmd into the
  39.    "Debugger Prefs" file inside your system folder.
  40.    
  41.  
  42. •• How to use (Think C 6.0.x or earlier) ••
  43.  
  44. 1) Delete the "Think dcmd glue" and "Think Put Lib" project files, because they can
  45.    only be used with Think C 7.0 or later.
  46.  
  47. 2) Create an empty project named "Think dcmd glue". Add the file "Think dcmd glue.c"
  48.    from the "Think dcmd glue source" folder to the project. Set the project type to
  49.    "Code resource". Bring the project up to date.
  50.  
  51. 3) Create an empty project named "Think Put Lib". Add all the files from the
  52.    "Think Put Lib source" folder to the project. Set the project type to
  53.    "Code resource". Bring the project up to date.
  54.  
  55. 4) Put the files "Think_dcmd.h", "Think_put.h", "Think dcmd glue" and "Think Put Lib"
  56.    where the Project Manager can find them (like in the "Mac Librairies" and
  57.    "Mac #includes" folders).
  58.  
  59. 5) Do the same with the files "dcmd.h" and "dcmdGlue.a.o". These files are available
  60.    along with MacsBug from ftp.apple.com in the dts/mac/tools/macsbug/ directory.
  61.    
  62.    If you have Think C 5.0.x or earlier, convert the "dcmdGlue.a.o" library into 
  63.    an A4-based project with the "oConv" application.
  64.  
  65. 6) Create a new project. Add the "dcmdGlue.a.o" library (or the corresponding
  66.    converted project file), the "Think dcmd glue" file and a copy of the "dcmd.c" file
  67.    to your project. Add your code in the dcmd.c file : write the CommandEntry code as
  68.    described in chapter 8 of the book "MacsBug Reference and Debugging Reference"
  69.    from Apple Computer, Inc.
  70.  
  71. 7) Using the "Set Project Type" command, set the project type to "Code resource", the
  72.    type to 'dcmd'. Choose the name and id of your dcmd. Remember that the dcmd name
  73.    (used to run the dcmd in MacsBug) is the name of the dcmd resource. Set the file
  74.    type to 'rsrc' and the creator to 'RSED'.
  75.    
  76.    VERY IMPORTANT : Check the "Custom header" checkbox.   
  77.  
  78. 8) Once you have built the dcmd, use a resource editor to copy the dcmd into the
  79.    "Debugger Prefs" file inside your system folder.
  80.  
  81.  
  82. •• Notes ••
  83.  
  84.  ◊ In Think C 7.0 or later, execute step 1-3 only once. For each new dcmd you want
  85.    to write, start at step 4.
  86.    
  87.  ◊ In Think C 6.0.x or earlier, execute step 1-5 only once. For each new dcmd you want
  88.    to write, start at step 6.
  89.    
  90.  ◊ If you want to use global variables, #include <SetUpA4.h> in the begining of the
  91.    dcmd.c file. Call RememmberA0() and SetUpA4() in the begining of the CommandEntry
  92.    procedure, and RestoreA4() in the end.
  93.  
  94.  ◊ To use the Think Put Library, add the "Think Put Lib" file to your project and
  95.    #include <Think_put.h> in the beginning of the dcmd.c file
  96.  
  97.  ◊ The Think Put Library in this package requires globals.
  98.  
  99.  
  100. •• Changes since version 1.0 ••
  101.  
  102.  ◊ Now compatible with "TestDcmd". "Break on entry" didn't work with version 1.0
  103.  
  104.  ◊ The "@1.π" project now has the "Use MacsBug name" flag set under "Debugging"
  105.  
  106.  ◊ Renamed global variables.
  107.  
  108.  ◊ Some fixes in the doc.
  109.  
  110. •• About ••
  111.  
  112.    Written by P. Stadelmann <Patrick.Stadelmann@etudiants.unine.ch>.   
  113.    Feel free to contact me if you have comments, suggestions or bugs to report.
  114.    
  115.    Thanks to R. Wesley.
  116.    
  117.    This package is public domain. However, the "dcmd.h" and "dcmdGlue.a.o"
  118.    files are copyrighted material from Apple Computer, Inc.